home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmtraversepmns.z / pmtraversepmns
Text File  |  1997-04-03  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEEPPPPMMMMNNNNSSSS((((3333))))                                            PPPPMMMMTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEEPPPPMMMMNNNNSSSS((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmTTTTrrrraaaavvvveeeerrrrsssseeeePPPPMMMMNNNNSSSS - traverse the performance metrics name space
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  13.  
  14.      iiiinnnntttt ppppmmmmTTTTrrrraaaavvvveeeerrrrsssseeeePPPPMMMMNNNNSSSS((((cccchhhhaaaarrrr ****nnnnaaaammmmeeee,,,, vvvvooooiiiidddd ((((****ddddoooommmmeeeettttrrrriiiicccc))))((((cccchhhhaaaarrrr ****))))))))
  15.  
  16.      cccccccc ............ ----llllppppccccpppp
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      The routine ppppmmmmTTTTrrrraaaavvvveeeerrrrsssseeeePPPPMMMMNNNNSSSS may be used to perform a depth-first traversal
  20.      of the Performance Metrics Name Space (PMNS).
  21.  
  22.      The traversal starts at the node identified by _n_a_m_e - if _n_a_m_e is a null
  23.      string, the traversal starts at the root of the PMNS.  Usually _n_a_m_e would
  24.      be the pathname of a non-leaf node in the PMNS.
  25.  
  26.      For each leaf node (i.e. performance metric) found in the traversal, the
  27.      user-supplied routine _d_o_m_e_t_r_i_c is called with the full pathname of that
  28.      metric in the PMNS as the single argument.  This argument is null-byte
  29.      terminated, and is constructed from a buffer that is managed internally
  30.      to ppppmmmmTTTTrrrraaaavvvveeeerrrrsssseeeePPPPMMMMNNNNSSSS.  Consequently the value is only valid during the call
  31.      to _d_o_m_e_t_r_i_c - if the pathname needs to be retained, it should be copied
  32.      using ssssttttrrrrdddduuuupppp(3C) before returning from _d_o_m_e_t_r_i_c.
  33.  
  34. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  35.      PPPPMMMMAAAAPPPPIIII(3) and ppppmmmmGGGGeeeettttCCCChhhhiiiillllddddrrrreeeennnn(3).
  36.  
  37. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  38.      PPPPMMMM____EEEERRRRRRRR____NNNNOOOOPPPPMMMMNNNNSSSS
  39.           A PMNS must have been loaded with ppppmmmmLLLLooooaaaaddddAAAASSSSCCCCIIIIIIIINNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) or
  40.           ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) before calling ppppmmmmTTTTrrrraaaavvvveeeerrrrsssseeeePPPPMMMMNNNNSSSS
  41.  
  42.      PPPPMMMM____EEEERRRRRRRR____NNNNAAAAMMMMEEEE
  43.           The initial pathname _n_a_m_e is not valid in the current PMNS
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.